home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr44 / cdbox210.zip / CD-BOX.DOC < prev    next >
Text File  |  1993-04-14  |  64KB  |  1,327 lines
  1. ╒════════════════════════════════════════════════════════════════════════════╕
  2. │                   CD-Box v2.10 - (C) Jeffrey Belt, 1992                    │
  3. ╘════════════════════════════════════════════════════════════════════════════╛
  4. Quick start:
  5.  
  6.   0. You must have a VGA display (color), a mouse, and an Adlib or
  7.        SoundBlaster card (v1.50 or above) - a hard disk is also highly
  8.        recommended.
  9.  
  10.   1. Create a directory in which you put all CD-BOX.* files, and every music 
  11.        file (.CMF, .MOD, .MUS, .ROL and .VOC) you can find, either as is or 
  12.        stored in .ZIP files. Also make sure SBFMDRV.COM, SOUND.COM, PLAY.EXE,
  13.        SPUTROL.COM, VPLAY.EXE and PKUNZIP.EXE (if you don't have them all, do
  14.        the best you can) are on the PATH (or the SOUND environment variable)
  15.        somewhere.
  16.  
  17.   2. Type CD-BOX and press Enter (the first time CD-Box is run, the directory
  18.        scan may take a looooong time, especially if you have many songs - be
  19.        patient, it will go much faster the second time).
  20.  
  21.   3. Fool around and see what CD-Box can do.
  22.  
  23. IF YOU HAVE TROUBLE, before you conclude that CD-Box is useless, see part III,
  24.   troubleshooting.
  25.  
  26. If you have players others than those listed above, check out CD-BOX.CFG.
  27.  
  28. If you like and use CD-Box, see part VI (at the end).
  29.  
  30. If you want more details:
  31.  
  32.   * Type CD-BOX/? at the DOS prompt
  33.  
  34.   * Read the rest of this document!
  35.  
  36. ══════════════════════════════════════════════════════════════════════════════
  37. Acknowledgments
  38.  
  39.    AdLib Music Synthetizer Card is a registered trademark of AdLib, Inc. Also,
  40.      SOUND.COM is copyrighted by AdLib, Inc.
  41.  
  42.    SoundBlaster is a registered trademark of Creative Labs, Inc. Also,
  43.      SBFMDRV.COM and VPLAY.EXE are copyrighted by Creative Labs, Inc.
  44.  
  45.    PKUNZIP is copyrighted by PKWARE, Inc.
  46.  
  47. CD-Box supports by default the following drivers/players (you are free to
  48.   change this by editing the CD-BOX.CFG file):
  49.  
  50.    SBFMDRV.COM and VPLAY.EXE from Creative Labs, Inc. They come with the
  51.        SoundBlaster.
  52.  
  53.    SOUND.COM from Adlib, Inc. It comes with the AdLib Music Synthetizer Card
  54.        (which I bought before switching to a SoundBlaster, but I have no
  55.        regrets...). There also is a SB-SOUND.COM from Creative Labs, Inc;
  56.        rename it to SOUND.COM for SPUTROL to work (or load it before running
  57.        CD-Box).
  58.  
  59.    SPUTROL.COM from the Sputter package, available from VersaWare (Adrienne
  60.        Cousins) (that one is Shareware). Last thing I know it was on
  61.        nic.funet.fi, and snake.mcs.kent.edu.
  62.  
  63.    PLAY.EXE which is completely anonymous (I downloaded it from a FTP server
  64.        somewhere which IT got from THE TASTE/MG BBS, 718-252-4529, as
  65.        ADLIBMUS.ZIP, with no accompanying documentation, no author name, no
  66.        nothing).
  67.  
  68. Other player programs I've heard of are, and you might try with CD-Box are:
  69.   SPUTCMF from the Sputter package, PLAYROL from Tracy Harton, MODPLAY from
  70.   Mark J Cox, WOWII from Thomas Meyer... See CD-BOX.CFG for details.
  71.  
  72. Exactly which program does what in detailed at the beginning of part II.
  73.  
  74.  
  75. ══════════════════════════════════════════════════════════════════════════════
  76.  
  77.                            TABLE OF CONTENTS
  78.  
  79. ══════════════════════════════════════════════════════════════════════════════
  80.  
  81.            Part I:   How to use CD-Box
  82.            Part II:  General questions & answers about CD-Box
  83.                        (including exactly which drivers/players are needed,
  84.                         some FTP addresses, how CD-Box interacts with them...)
  85.            Part III: Trouble-shooting
  86.            Part IV:  Version history, how you can help, and thanks
  87.            Part V:   License & absence of warranty
  88.            Part VI:  How to show your appreciation for CD-Box
  89.  
  90. ══════════════════════════════════════════════════════════════════════════════
  91. Compatibility
  92.  
  93. CD-BOX v2.10 IS FULLY COMPATIBLE WITH ALL VERSIONS OF CD-BOX ABOVE 2.00. You
  94.   can overwrite the old CD-Box files with the new ones, provided the old
  95.   version is v2.00, v2.01 or v2.02. If you're one of those who still have
  96.   CD-Box v1.61 or below, CD-Box will ask you to delete the SONGS.DAT file.
  97.  
  98. ══════════════════════════════════════════════════════════════════════════════
  99. New features in CD-Box v2.10:
  100.  
  101. Major changes:
  102.  
  103. - Internal support for .MOD files
  104.  
  105. - CD-Box now gets its data about drivers and players from a configuration
  106.     file, CD-BOX.CFG. The default drivers/players supported are almost the
  107.     same as in CD-Box v2.01, but you can easily change that and have it
  108.     support any driver/player you happen to have. See CD-BOX.CFG for details.
  109.  
  110. - CD-Box also provides DUAL internal/external support. For instance, CD-Box
  111.     can play .CMF files by itself (it needs only the driver), but if you wish,
  112.     you can force it to use an external driver (this is implemented to get
  113.     CD-Box ready for more internal support), or even try to use both. See also
  114.     CD-BOX.CFG.
  115.  
  116. - Files... mode added
  117.  
  118. Minor changes:
  119. - more free memory for .MUS/.MOD/.VOC files!
  120. - format unplayable -> .XXX pilot light & songs grayed when selected
  121. - /L parameter added
  122. - 4 animations added (UFO, Boat, Rocket, Spin)
  123. - mouse driver completely rewritten -> light gradients on mouse pointers
  124. - a correct "About" dialog
  125. - better packing for CD-BOX.RSR (a bit smaller, yet contains 100K more!)
  126. - better CRASH! message
  127. - temporary drive redirection (Temp=)
  128. - "fast play" (right clicking on song) turns off "Loop" (whew!)
  129.  
  130. Fixed bugs:
  131. - mouse-at-double-its-horizontal-position-on-certain-drivers bug
  132. - bug caused by too long song titles
  133. - explicit error message instead of crash if PKUNZIP not found while analyzing
  134. - random animation timeout not depending on processor speed any more
  135. - "Rem." and "Total" keep their settings throughout the whole playback
  136. - weird button behaviour when in Random mode
  137.  
  138. ══════════════════════════════════════════════════════════════════════════════
  139.  
  140.                               PART I: CD-BOX
  141.  
  142. ══════════════════════════════════════════════════════════════════════════════
  143. *** What does CD-Box do?
  144. ──────────────────────────────────────────────────────────────────────────────
  145.  
  146. CD-Box is, stated simply, a program which plays back music files on the AdLib
  147.   Music Synthetizer Card and the SoundBlaster card. However, it is also very
  148.   pretty and fun to use - it runs in 256 colors and uses the mouse (not the
  149.   keyboard).
  150.  
  151. CD-Box's main features:
  152.  
  153.   - A pretty interface and fun animation - CDs pop up and down and start and
  154.       stop spinning, pages scroll... including random events I'll let you
  155.       discover!
  156.  
  157.   - Support for .CMF, .MOD, .MUS, .ROL and .VOC music/sound files (.CMF, .MOD
  158.       and .VOC files work with SoundBlaster only). These files can also be
  159.       stored in .ZIP files to save disk space - CD-Box will find them and play
  160.       them from the archive (using a RAM drive if you want).
  161.  
  162.   - CD-Box allows you to easily program a selection of songs; it waits for you
  163.       to select ALL the songs before starting to play the first one.
  164.  
  165.   - Instead of selecting songs, you can tell CD-Box how long you want the
  166.       playback to last, and CD-Box will automatically select songs for you.
  167.       You can even do that from the DOS command line (or a batch file), and
  168.       CD-Box will play the songs, then exit right back to DOS.
  169.  
  170.   - CD-Box makes it easy to choose files in which to pick songs (using Files 
  171.       mode, one of the latest additions) - so if you ZIPped your songs by 
  172.       category, you can tell CD-Box which categories to use!
  173.  
  174.   - No data file to keep to date; bank filenames and song titles can be
  175.       modified directly from CD-Box, which will save your changes to disk.
  176.       CD-Box also knows the titles and lengths of numerous songs, and when it
  177.       encounters unknown songs, can sometimes (it depends on the format)
  178.       extract data from the files on disk.
  179.  
  180.   - CD-Box is able to examine the SOUND environnment variable and of loading
  181.       drivers and player programs from there if necessary (as any good
  182.       SoundBlaster software should do).
  183.  
  184.  
  185. ──────────────────────────────────────────────────────────────────────────────
  186. And now, the fun part: how CD-Box works
  187.  
  188. You run it by typing CD-BOX at the DOS prompt. Obvious, really. You are then
  189.   in...
  190.  
  191. ══════════════════════════════════════════════════════════════════════════════
  192. *** SELECT MODE: to select and play songs
  193. ──────────────────────────────────────────────────────────────────────────────
  194.  
  195.   - Move between the pages by clicking on the "Rewind" and "Forward" buttons.
  196.       Pressing the RIGHT mouse button on "Rewind" and "Forward" brings you to
  197.       the first and last page, respectively.
  198.  
  199.   - Select one or more songs to play by clicking on the small button next to
  200.       the songs' names; they will be played back in the order you selected
  201.       them. The digital display changes color and displays the total length
  202.       time of your selection.
  203.  
  204.   - Click on "Loop" if you want your selection to be played over and over
  205.       again.
  206.  
  207.   - Click on "Play" to play the songs - you'll be in Play mode (see below).
  208.  
  209.   - Clicking on "Random" brings you into Random mode. You can then select the
  210.       total playing time you wish, by clicking on the "Rewind" and "Forward"
  211.       buttons; pressing the RIGHT mouse button brings up the minimum and
  212.       maximum playing time, respectively. Once the desired time is displayed
  213.       on the digital display, click on "Play". CD-Box will randomly select
  214.       additional songs until the desired time is reached, then play the songs.
  215.  
  216. ******************************************************************************
  217.  NOTE: Certain songs may be of unknown length (they were not known to CD-Box
  218.  and they have never been played yet). When such a song is selected, CD-Box
  219.  supposes the length is zero. Therefore, if you use the "Random" button and
  220.  suchs songs are chosen, the actual playing time may be far longer than the
  221.  playing time you entered; so try not to use "Random" before you have played
  222.  all the songs (if you do, Esc still works). Of course a way to play all the
  223.  songs is to use Random mode and choose the maximum playing time.
  224. ******************************************************************************
  225.  
  226.   - Clicking on "Random" while in Random mode, exits Random mode.
  227.  
  228.   - Clicking on the wide "Unselect" button will unselect ALL the songs.
  229.  
  230.   - Finally, click on "Eject" to quit.
  231.  
  232.  
  233. ══════════════════════════════════════════════════════════════════════════════
  234. *** PLAY MODE: while songs are being played back
  235. ──────────────────────────────────────────────────────────────────────────────
  236.  
  237.   - Each song is played in turn, and then de-selected, unless "Loop" is in the
  238.       down position, in which case they are reselected to be played again
  239.       later.
  240.  
  241.   - Pressing Esc while a song is playing interrupts the current song, and
  242.       CD-Box starts looking for the next one. If you press Esc between songs,
  243.       playback stops entirely (songs not yet played remain selected). You've
  244.       got to press Esc twice quite fast to stop the playback in fast mode.
  245.  
  246. If the cursor is a yellow arrow, you also have access to the real-time clock
  247.   and the following functions (.CMF and .MOD files only (for now!)):
  248.  
  249.   - Stop: stops playback entirely (same as pressing Esc between songs).
  250.  
  251.   - Skip: interrupts the current song (same as pressing Esc while playing).
  252.  
  253.   - Pause/Resume: toggle it once to pause the music, and toggle it again to
  254.       have it pick up where it left off.
  255.  
  256.   - Rem.: if pressed, the digital display shows the time left until the song
  257.       or the total selection ends (see next button), as far as CD-Box can
  258.       tell; if not, the digital display shows the time elapsed since the
  259.       beginning of the song or the total selection.
  260.  
  261.   - Total: if pressed, the digital display shows the time elapsed or left (see
  262.       previous button) for the current song; if not, it shows the time elapsed
  263.       or left for the whole selection. Got it?
  264.  
  265. Play mode switches back to Select mode when playback ends (whether you
  266.   interrupted it or not).
  267.  
  268.  
  269. ══════════════════════════════════════════════════════════════════════════════
  270. *** MODIFY MODE: used to modify bank files and song titles
  271. ──────────────────────────────────────────────────────────────────────────────
  272.  
  273. Click on the wide "Modify" button to enter Modify mode. All the songs will be
  274.   unselected, and the row of buttons will flip and reveal another set of
  275.   buttons. "Rewind" and "Forward" work the same.
  276.  
  277.   - You can display the song titles, bank files or filename by clicking on one
  278.       of the three buttons at the right.
  279.  
  280.   - If you click on a small button next to a song, a dot cursor will appear
  281.       and you will be able to modify whatever is displayed, using the keyboard
  282.       (Backspace, Enter and Escape do the ovious things). Any changes you type
  283.       in will be automatically saved to disk once you exit CD-Box.
  284.  
  285.  
  286. ══════════════════════════════════════════════════════════════════════════════
  287. *** GOTO MODE: used to jump to a specific title (or filename, see Files mode)
  288. ──────────────────────────────────────────────────────────────────────────────
  289.  
  290. Click on "Goto...", and an alphabetic set of buttons will appear. From there,
  291.   simply choose a letter, and CD-Box will "Rewind" or "Forward" directly to
  292.   the page containing the first song starting by the letter you selected, and
  293.   flash that song briefly.  If no such song exists, CD-Box tries with the next
  294.   letter, and the next, and may finally give up by giving an error message.
  295.  
  296. When you exit Goto mode, either automatically, or by clicking on Goto a second
  297.   time, you will be brought back to the same mode you were in before entering
  298.   Goto mode. Goto is accessible from all modes.
  299.  
  300.  
  301. ══════════════════════════════════════════════════════════════════════════════
  302. *** FILES MODE: to tag/untag files for scanning
  303. ──────────────────────────────────────────────────────────────────────────────
  304.  
  305. GENERAL WARNING: this mode is the latest implemented. It seems to be working
  306.   okay, so I included it in this release, but it has not been as thouroughly 
  307.   tested as the rest of CD-Box - therefore, there may be some bugs (I don't 
  308.   think so but you never know). Use at your own risk!
  309.  
  310. Click on "Files...", and CD-Box will save any changes you have made (bank
  311.   files, song titles, whatever), and promptly forget all the songs in memory.
  312.   Files names will then be displayed instead of song titles. These files are
  313.   NOT the song files themselves, but rather the files CD-Box scanned to get
  314.   the songs in memory - the difference is that .ZIP files will be displayed as
  315.   such, instead of having a separate entry for each file in the .ZIP file (as
  316.   is the case in Modify mode when the "File" button is pressed).
  317.  
  318. All files are selected by default. You can browse through the list using
  319.   "Rewind" and "Forward" as usual, and "Goto..." a specific filename... and
  320.   when you click on "Rescan", CD-Box will rescan ONLY the files left selected.
  321.   Thus, if you left all the files selected, CD-Box will reload all the songs
  322.   and nothing will be changed. If you unselected them all, CD-Box will load no
  323.   songs.
  324.  
  325. This serves as a "filter" for the songs displayed in CD-Box, and used by (for
  326.   instance) Random mode. If your songs are ZIPped by category, switching to 
  327.   Files mode and choosing only certain categories will tell CD-Box to display 
  328.   and use only the songs in these categories. If you don't use .ZIP files at 
  329.   all, then probably Files mode will not be of much use to you.
  330.  
  331. Note that the files displayed are not all the files in the directory, but 
  332.   rather those that contain songs. Also, if you specified /L at startup, any 
  333.   unplayable files in the directory will not be displayed. And, if you 
  334.   specified file specifications at startup (for instance, CD-BOX *.MOD 
  335.   Z*.ZIP), only the files matching these specifications will be displayed.  
  336.   All this is cumulative, of course. The command line serves as a first
  337.   filter, and Files mode then enables you to choose the filtered files by
  338.   hand.
  339.  
  340. Files mode much simpler to use than to describe, believe me... try it!
  341.  
  342.  
  343. ══════════════════════════════════════════════════════════════════════════════
  344. *** DEBUG MODE: to have a quick look at CD-Box's startup
  345. ──────────────────────────────────────────────────────────────────────────────
  346.  
  347. This is not really a mode in the sense of those described above, but is a
  348.   command-line parameter important enough to be included here. Typing CD-BOX/D
  349.   at the DOS prompt:
  350.  
  351.   * checks the CD-BOX.CFG file for errors, reporting any, so that you can
  352.       correct them;
  353.  
  354.   * displays, for each driver and player, whether it was found or not;
  355.  
  356.   * scans the directory for songs, displaying each song name in turn, so that
  357.       you may find which song exactly makes CD-Box crash (if any).
  358.  
  359.  
  360. ══════════════════════════════════════════════════════════════════════════════
  361.  
  362.                         PART II: GENERAL QUESTIONS
  363.  
  364. ══════════════════════════════════════════════════════════════════════════════
  365. *** How does CD-Box play songs?
  366. ──────────────────────────────────────────────────────────────────────────────
  367.  
  368. It depends on the format. For each format, CD-Box follows these rules:
  369.  
  370.   * If there is a section about this format in CD-BOX.CFG ([<format>]), then
  371.       CD-Box will provide external support, and:
  372.  
  373.       * If there is a "Dual=yes" statement in the section, and CD-Box has 
  374.           internal support for this format (.CMF or .MOD), then CD-Box will 
  375.           first try playing such songs using its own routines, and, if this 
  376.           fails (error while loading or whatever), use the external player.
  377.  
  378.       * If there is no such statement in the section, then CD-Box will ALWAYS 
  379.           use this player to play the song, using the parameters given in
  380.           CD-BOX.CFG.
  381.  
  382.   * If there is no section on this format in CD-BOX.CFG, then CD-Box will use 
  383.       its internal routines to play the song, if any. CD-Box currently
  384.       provides internal support for .CMF and .MOD files.
  385.  
  386.   * In all other cases, CD-Box will NOT play songs of this format (the
  387.       corresponding pilot light above the song names is grayed).
  388.  
  389. Usually you'll want CD-Box to play songs by itself; it's by far the easiest
  390.   way, there's no player to install, and you can pause, resume and stop the
  391.   song using the mouse. However, you would use an external player if:
  392.  
  393.   * CD-Box provides no internal support for the corresponding format
  394.  
  395.   * Or the sound given by the player you have is better than that of CD-Box, 
  396.       or the player supports a wider range of capabilities (what if you've got 
  397.       the AdLib and have a player which can play .CMF on your card?), so you
  398.       might want to override CD-Box's routines for that format.
  399.  
  400. Note that even if CD-Box does have internal support for some formats, it may
  401.   still need the corresponding driver. See right below for details.
  402.  
  403.  
  404. ══════════════════════════════════════════════════════════════════════════════
  405. *** Exactly what programs do I need for each song format?
  406. ──────────────────────────────────────────────────────────────────────────────
  407.  
  408. In addition to CD-BOX.EXE (the program), CD-BOX.RSR (the resource file), and 
  409.   CD-BOX.CFG (the configuration file), you need songs to play, and a player 
  410.   program in most cases. The default (you can change that, see CD-BOX.CFG for 
  411.   details) music playback programs supported by CD-Box and the corresponding 
  412.   song formats are:
  413.  
  414.     ┌─────────────────────────────┐
  415.     │ Creative Music Files (.CMF) │ SoundBlaster only
  416.     └─────────────────────────────┘
  417.         You need the sound driver SBFMDRV.COM from Creative Labs, Inc, and it
  418.         has to be loaded in memory before CD-Box is run. (You can remove it by
  419.         typing SBFMDRV /U once you exit CD-Box). No other program is
  420.         necessary, .CMF routines are programmed directly into CD-Box.
  421.  
  422.     ┌────────────────────────┐
  423.     │ Amiga MOD files (.MOD) │ SoundBlaster only
  424.     └────────────────────────┘
  425.         You need nothing except lots of memory; CD-Box is linked to internal
  426.         .MOD playing routines.
  427.  
  428.     ┌────────────────────┐
  429.     │ Music files (.MUS) │ AdLib & SoundBlaster
  430.     └────────────────────┘
  431.         You need PLAY.EXE. Each .MUS file also needs a .SND bank file, so be
  432.         sure to put them in the directory too. (ex: AGNES.MUS and AGNES.SND,
  433.         MULL.MUS and MULL.SND...)
  434.  
  435.         Note: .MUS bank files (.SND files) are different from Macintosh raw 
  436.         sound files (.SND extension also) - the former contain instrument data
  437.         and the latter a complete digitized sound. Macintosh .SND files can be
  438.         converted to .VOC using appropriate utilities such as SOX, available
  439.         at garbo.uwasa.fi in pc/sound (that holds for other formats such as
  440.         .AU and .WAV).
  441.  
  442.     ┌─────────────────────┐
  443.     │ ROLand files (.ROL) │ AdLib & SoundBlaster
  444.     └─────────────────────┘
  445.         You need SPUTROL.COM, and the sound driver SOUND.COM from AdLib, Inc;
  446.         but you don't have to load it before running CD-Box. SPUTROL will
  447.         itself load it if necessary, and unload it when done. .ROL files also
  448.         need at least one .BNK bank file, which usually is STANDARD.BNK.
  449.  
  450.         If you have SB-SOUND.COM from Creative Labs, Inc, rename it to
  451.         SOUND.COM so that SPUTROL can detect it (unless you use another player
  452.         which properly detects SB-SOUND...)
  453.  
  454.         Since many of you asked... ROL2CMF will convert .ROL to .CMF so you
  455.         can use CD-Box's internal routines instead of SPUTROL. ROL2CMF is
  456.         widely available on FTP servers, such as saffron.inset.com, directory
  457.         pub/sound/players.
  458.  
  459.     ┌─────────────────────────────────┐
  460.     │ SoundBlaster VOiCe files (.VOC) │ SoundBlaster only
  461.     └─────────────────────────────────┘
  462.         You need VPLAY.EXE. These are digitized sound files and not real music
  463.         files, so the space taken up on disk can be HUGE.
  464.  
  465.     ┌────────────┐
  466.     │ .ZIP files │ All formats
  467.     └────────────┘
  468.         You need PKUNZIP.EXE (see section on .ZIP files below).
  469.  
  470.  
  471. All the song files have to reside in CD-Box's directory; the program files do
  472.   not have to, but make sure CD-Box has access to them (through a PATH 
  473.   statement for instance). CD-Box also examines the SOUND environnment 
  474.   variable and is able to load drivers and players from there if necessary.
  475.  
  476. To see if CD-Box detects properly your drivers and player programs, type
  477.   CD-BOX/D at the DOS prompt.
  478.  
  479.  
  480. ══════════════════════════════════════════════════════════════════════════════
  481. *** How do I tell CD-Box to support other drivers/players?
  482. ──────────────────────────────────────────────────────────────────────────────
  483.  
  484. If you have a player program that meets the following restrictions:
  485.  
  486.   - it can be run in "quiet" mode, i.e. no output of ANY kind while running,
  487.       no error messages, no nothing.
  488.  
  489.   - it does not switch to a specific video mode (for instance, text mode) when
  490.       run.
  491.  
  492.   then CD-Box can support it. Modify the CD-BOX.CFG configuration file using
  493.   any ASCII text editor to do this.
  494.  
  495.  
  496. ══════════════════════════════════════════════════════════════════════════════
  497. *** How do I add or remove songs to CD-Box?
  498. ──────────────────────────────────────────────────────────────────────────────
  499.  
  500. The song titles displayed in CD-Box depend entirely on the music files in the
  501.   current directory (either in .ZIP archives or not). If you want to add songs
  502.   to CD-Box, simply put them in the current directory. To remove them, delete
  503.   the files. In other words, CD-Box always reflects the current directory -
  504.   only the file names are replaced by song titles.
  505.  
  506. The above paragraph is modified by the fact that if you specify file 
  507.   specifications on the command line (for instance, CD-BOX *.ZIP NEW*.*), the 
  508.   song titles will be those found in the specified files only.
  509.  
  510.  
  511. ══════════════════════════════════════════════════════════════════════════════
  512. *** What's all this about .ZIP files?
  513. ──────────────────────────────────────────────────────────────────────────────
  514.  
  515. CD-Box is able to look into .ZIP files to see if there are any songs there; if
  516.   it finds any, the corresponding title will appear on the main screen, and
  517.   the song will be treated just as any other song. This means your songs can
  518.   be packed in .ZIP files in CD-Box's directory to save space; CD-Box will
  519.   find them anyway.
  520.  
  521.  
  522. *** When does CD-Box uncompress the songs stored in .ZIP files?
  523.  
  524. Unpacking occurs in two cases only:
  525.  
  526.   - at startup, if a song found in a .ZIP archive is not known to CD-Box, it
  527.       will exploded using PKUNZIP.EXE so that it can be analyzed. The program
  528.       will try to extract the most information from the file (title and length
  529.       in particular); the "Analyzing song" indicator is lit up. When done,
  530.       CD-Box will remove the unpacked file.
  531.  
  532.   - just before playing a song stored in a .ZIP archive, the ".ZIP" indicator
  533.       lights up and CD-Box invokes PKUNZIP.EXE to explode the song file, and
  534.       the bank file if necessary. When done playing, the unpacked files are
  535.       removed also.
  536.  
  537.  
  538. *** Where are files exploded to?
  539.  
  540. Files temporarily extracted from .ZIP files reside on:
  541.  
  542.   - the drive/directory specified by the Temp= statement in CD-BOX.CFG;
  543.  
  544.   - if Temp= is not specified, the drive/directory specified by the TEMP
  545.       environnment variable;
  546.  
  547.   - if TEMP doesn't exist, to the default drive/directory.
  548.  
  549. Always make sure there's enough room to hold the largest expanded song!
  550.  
  551.  
  552. *** What program is necessary to take full advantage of this feature?
  553.  
  554. PKUNZIP.EXE from PKWare, Inc. If you don't have it, or if it is not reachable
  555.   through a PATH statement, and if you have .ZIP files in CD-Box's directory,
  556.   the message "Unable to explode song" will appear. CD-Box may also crash at
  557.   startup.
  558.  
  559. The bottom line: using .ZIP files with CD-Box is pretty easy and
  560.   straightforward. In the case of .MUS and .ROL music files, it also saves an
  561.   average of 80% of disk space!!! Believe me, IT'S WORTH IT!
  562.  
  563.  
  564. ══════════════════════════════════════════════════════════════════════════════
  565. *** Dual support? What's that?
  566. ──────────────────────────────────────────────────────────────────────────────
  567.  
  568. .CMF and .MOD files: it means CD-Box can play this format by itself. So you
  569.   have three choices:
  570.  
  571.   * The easiest: just let it play the songs and don't worry about anything
  572.       else.
  573.  
  574.   * If CD-Box won't play this format on your particular computer, you can try
  575.       overriding its routines by telling it to use an external player (ex:
  576.       AdLib users might have a .CMF player that works on their card). You
  577.       simply have to insert the appropriate statements in CD-BOX.CFG.
  578.  
  579.   * CD-Box can also use both: try playing the format by itself, and if that
  580.       fails, use an external player; you have to insert whatever is needed to
  581.       run the player in CD-BOX.CFG, and add a "Dual=yes" statement (ex: CD-Box
  582.       may not be able to play all your .MOD files, so you might want to use an
  583.       external player for the ones it cannot play. See .MOD files in part III,
  584.       trouble-shooting).
  585.  
  586.  
  587. ══════════════════════════════════════════════════════════════════════════════
  588. *** Is there any way I can skip the animation?
  589. ──────────────────────────────────────────────────────────────────────────────
  590.  
  591. Indeed there is. Type CD-BOX/F at the DOS prompt.
  592.  
  593. You can also skip the title screen, but still have the animation, by pressing
  594.   a key while CD-Box is loading (before it switches to graphics mode).
  595.  
  596.  
  597. ══════════════════════════════════════════════════════════════════════════════
  598. *** Are there any shortcuts to make things happen more quickly?
  599. ──────────────────────────────────────────────────────────────────────────────
  600.  
  601. Try clicking the RIGHT mouse button. For instance, clicking the right mouse
  602.   button on a song button plays the song immediately, or clicking the right
  603.   mouse button on the "Rewind" and "Forward" buttons go to the beginning and
  604.   end of the song index, respectively. But if that's still too slow for you,
  605.   the /F parameter is even faster, but then you'll skip ALL the animations.
  606.  
  607.  
  608. ══════════════════════════════════════════════════════════════════════════════
  609. *** What does that "XXX duplicate!" message at startup mean?
  610. ──────────────────────────────────────────────────────────────────────────────
  611.  
  612. This can only happen if you use .ZIP files; it means you have two or more
  613.   files which have exactly the same filename in the CD-Box directory. CD-Box
  614.   ignores all duplicate filenames and remembers only the first one found. It's
  615.   not an error, it's a warning, but it can be annoying.
  616.  
  617. You have the same file twice in the directory (one in a .ZIP file, another in
  618.   a .ZIP file or simply in the directory). So delete one or rename the other.
  619.  
  620.  
  621. ══════════════════════════════════════════════════════════════════════════════
  622. *** How does CD-Box remember the title and length of songs?
  623. ──────────────────────────────────────────────────────────────────────────────
  624.  
  625. Files found in the current directory are the ones loaded, and the bank file
  626.   and title given depend on the following criteria:
  627.  
  628.   - If there is a SONGS.DAT file in the directory, and if it contains that
  629.       song, CD-Box loads the data from it (SONGS.DAT is an external database
  630.       CD-Box uses to remember songs).
  631.  
  632.   - Otherwise, if CD-Box knows that song intrisically (there is another
  633.       database directly programmed into CD-BOX.RSR), the data is read from
  634.       there.
  635.  
  636.   - If all this fails, then CD-Box tries to make the best possible guesses:
  637.  
  638.       + bank file: usually BNK974.BNK, or filename.SND, or none.
  639.  
  640.       + song title: extracted from disk (.CMF and .MOD), otherwise same as
  641.           filename.
  642.  
  643.       + length: 0 (unknown), except for .ROL files, where the length is
  644.           computed directly from the file on disk.
  645.  
  646.  
  647. All this is recorded in CD-Box's external database (SONGS.DAT); if the
  648.   database doesn't exist, it is created. Any changes you make, and of course
  649.   the changes in length as computed when playing the song, take over the
  650.   default values, and are recorded as well.
  651.  
  652. All changes are actually written to disk when you quit CD-Box (Eject).
  653.  
  654. At the time of this writing, CD-Box intrinsically knows about 150 songs, but
  655.   this number keeps changing. Type CD-BOX/I at the DOS prompt to know exactly
  656.   how many.
  657.  
  658.  
  659. ══════════════════════════════════════════════════════════════════════════════
  660. *** How can I tell CD-Box to load only the song files my system supports?
  661. ──────────────────────────────────────────────────────────────────────────────
  662.  
  663. If you're missing some drivers or player programs, you might want CD-Box to
  664.   load only the files it can play, instead of loading them all and issuing an
  665.   error message each time. Give it the /L parameter at startup (CD-BOX /L).
  666.   Note that in this case CD-Box will also ignore songs in .ZIP archives if
  667.   PKUNZIP.EXE cannot be found.
  668.  
  669. Unplayable songs (i.e. missing driver or player) are grayed when you select
  670.   them in CD-Box.
  671.  
  672.  
  673. ══════════════════════════════════════════════════════════════════════════════
  674. *** What are the command line parameters?
  675. ──────────────────────────────────────────────────────────────────────────────
  676.  
  677. CD-BOX/? gives you a quick summary. Otherwise, here are the details:
  678.  
  679.  
  680.   * filespec: instead of scanning the entire directory, CD-Box will scan only
  681.         the files matching your file specifications. For instance, if you want 
  682.         CD-Box to load the .MUS and .ROL files only, type CD-BOX *.MUS *.ROL; 
  683.         or if you just got a brand new archive containing new songs called 
  684.         ALLNEW.ZIP, and you want CD-Box to scan only that archive, type CD-BOX 
  685.         ALLNEW.ZIP. An alternative is to use Files mode (see above). The
  686.         default for filespec is, of course, *.*.
  687.  
  688.  
  689.   * /F: All non-essential animation is skipped, including the title screen,
  690.         CDs popping up and down, buttons flipping over... Use this parameter
  691.         if CD-Box runs too slowly on your computer, or if you're a little
  692.         short on memory (you get thrown back to DOS with messages like "Not
  693.         enough memory to load..." or "VGA Sprite Manager has run out of
  694.         memory!").
  695.  
  696.         If you don't specify the /F parameter, you can still skip the title
  697.         screen by pressing a key while CD-Box is loading (before it switches
  698.         to graphics mode).
  699.  
  700.  
  701.   * /I: Displays how much memory CD-Box detects and reserves for animation
  702.         purposes, and also how many songs are in the internal and external
  703.         databases.
  704.  
  705.  
  706.   * /L: Tells CD-Box NOT to load the song formats which cannot be played (i.e.
  707.         a driver is not loaded or missing or a player program is missing). In
  708.         other words, CD-Box does not load songs which corresponding pilot
  709.         light is grayed. This includes .ZIP files; they will not be scanned if
  710.         PKUNZIP.EXE cannot be found.
  711.  
  712.  
  713.   * /P: Loads CD-Box, plays n minutes of music by switching to Random mode,
  714.         and then exits back to DOS upon completion of the last song. If Esc is
  715.         pressed between songs, playback interrupts just as usual, and normal
  716.         operation is resumed: you can then use the mouse to choose songs,
  717.         change titles...
  718.  
  719.  
  720.   * /R: Removes the files specified on the command line from the external 
  721.         database (SONGS.DAT). You have to specify the complete filenames (no 
  722.         wildcards), not the song titles. For instance, to remove the files 
  723.         IMPACT7.MOD and SPACETR.MOD from SONGS.DAT, you would type CD-BOX /R
  724.         IMPACT7.MOD SPACETR.MOD. You shouldn't ever need to do this, except in
  725.         extremely rare cases where CD-Box would have fouled up and recorded a
  726.         song length of 45613248756:18 for a specific song...
  727.  
  728.  
  729.   * /V: Displays the contents (filename, bank filename, title and length) of 
  730.         the external database (SONGS.DAT) on the screen, pausing when the 
  731.         screen is full. Blank entries in the Bank column indicate the file 
  732.         does not need any bank file (.CMF, .MOD and .VOC), and blank entries 
  733.         in the Length column indicate the length of the song is not known (0). 
  734.         If you want to save this listing to a file, specify a filename, like 
  735.         this:
  736.  
  737.                                CD-BOX /V=filename
  738.  
  739.         Output will be saved to the file filename.TXT.
  740.  
  741.  
  742.   * /D: This is a debugging tool which displays:
  743.  
  744.           - whether any errors were found in CD-BOX.CFG;
  745.  
  746.           - the complete paths to all the drivers and players specified in
  747.               CD-BOX.CFG, if found;
  748.  
  749.           - the name of each file as it is read and analyzed from the 
  750.               directory when CD-Box starts up. I left it because CD-Box does
  751.               not verify whether a music file is valid or not before analyzing
  752.               it. So, if you try to run CD-Box and you get a "CRASH!", try
  753.               using /D, and chances are you'll spot the file which is invalid.
  754.               REMOVE THIS FILE FROM THE DIRECTORY!
  755.  
  756.             There are a few checking routines to prevent this, however, so you
  757.               might get an "Invalid .ROL file" message or equivalent. In that
  758.               case, remove the file too.
  759.  
  760.             Duplicate songs are also displayed and reported.
  761.  
  762.  
  763. ══════════════════════════════════════════════════════════════════════════════
  764. *** I have an AdLib card, is there a way I can play .CMF/.MOD/.VOC files?
  765. ──────────────────────────────────────────────────────────────────────────────
  766.  
  767. Yes... if you have a player which can do that. CD-Box can't. If you have FTP 
  768.   or News access, ask around, I've heard of an AdLib .CMF player, and of 
  769.   something to make the AdLib play .MODs. Whether they exist, and can be made 
  770.   to run with CD-Box (using CD-BOX.CFG) is another matter.
  771.  
  772.  
  773. ══════════════════════════════════════════════════════════════════════════════
  774. *** Is there anything else I should know about CD-Box?
  775. ──────────────────────────────────────────────────────────────────────────────
  776.  
  777. Well... there is. There are random animations happening at irregular
  778.   intervals. If you don't use the /F parameter and are patient, you should see
  779.   some from time to time.
  780.  
  781.  
  782. ══════════════════════════════════════════════════════════════════════════════
  783.  
  784.                          PART III: TROUBLE-SHOOTING
  785.  
  786. ══════════════════════════════════════════════════════════════════════════════
  787.                         CRASHES DURING SONG ANALYSIS
  788. ══════════════════════════════════════════════════════════════════════════════
  789. *** I get a "PKUNZIP either not found or crashed..." error message
  790. ──────────────────────────────────────────────────────────────────────────────
  791.  
  792. Run CD-BOX/D. If PKUNZIP.EXE is found, then CD-Box will say so... and crash 
  793.   while analyzing files stored in a .ZIP archive. Try unZIPping this archive 
  794.   by hand, and see what happens. The problem may be that the temporary drive 
  795.   or directory (Temp= in CD-BOX.CFG, or TEMP in your environnment) is invalid.
  796.  
  797. If PKUNZIP.EXE is not found, then you have a song in a .ZIP archive that
  798.   CD-Box tried to explode, but couldn't. CD-Box can read .ZIP files by itself,
  799.   but cannot extract files. So either make PKUNZIP.EXE available through the
  800.   path, or delete the .ZIP archive.
  801.  
  802. Another solution is to tell CD-Box not to load songs from .ZIP files if
  803.   PKUNZIP.EXE is not available; in that case, start CD-Box with the /L
  804.   parameter.
  805.  
  806.  
  807. ══════════════════════════════════════════════════════════════════════════════
  808. *** I get a "CRASH!" message while CD-Box analyzes a song
  809. ──────────────────────────────────────────────────────────────────────────────
  810.  
  811. Type CD-BOX/D to find the file that makes CD-Box crash. Then:
  812.  
  813.   * If it's while analyzing an uncompressed song, it means the song has an
  814.       invalid format, and CD-Box crashes when trying to extract meaningful
  815.       values like song title and song length. Delete that song file!
  816.  
  817.   * If it's while analyzing a .ZIP archive, it means the .ZIP is either empty
  818.       or is corrupted. Put something in it, fix it or get rid of it!
  819.  
  820.  
  821. ══════════════════════════════════════════════════════════════════════════════
  822.                       REFUSAL TO PLAY CERTAIN SONGS
  823. ══════════════════════════════════════════════════════════════════════════════
  824. *** CD-Box displays a "Driver not found" message!
  825. ──────────────────────────────────────────────────────────────────────────────
  826.  
  827. .CMF:
  828.  
  829. You're trying to play a .CMF file but haven't loaded the SBFMDRV driver before
  830.   starting CD-Box. Having SBFMDRV.COM on disk is not enough, it has to be
  831.   loaded too (you can always unload it afterwards by typing SBFMDRV/U).
  832.  
  833. Others:
  834.  
  835. The driver specified in the CD-BOX.CFG file could not be found. Either the
  836.   driver is not on the PATH or SOUND environnment variable, or the driver name
  837.   is mispelled in the CD-BOX.CFG file. Typing CD-BOX/D at the DOS prompt may
  838.   help.
  839.  
  840.  
  841. ══════════════════════════════════════════════════════════════════════════════
  842. *** CD-Box displays a "Player program not found" message!
  843. ──────────────────────────────────────────────────────────────────────────────
  844.  
  845. You have tried playing a song, and the associated player program was not found
  846.   (the pilot light at the top should be grayed). Make note of the format
  847.   causing problems, then run CD-Box with the /D parameter. If the
  848.   corresponding program is displayed as "not found.", then you can't play
  849.   these songs, unless:
  850.  
  851.   * You get the program and put it in CD-Box's directory, the directory from
  852.       the SOUND environnment variable, or somewhere on your PATH.
  853.  
  854.   * Or you modify the CD-BOX.CFG file to have CD-Box support another player
  855.       you might have for that format. See CD-BOX.CFG for details.
  856.  
  857.  
  858. ══════════════════════════════════════════════════════════════════════════════
  859. *** CD-Box displays a "Don't know how to play" message!
  860. ──────────────────────────────────────────────────────────────────────────────
  861.  
  862. There's something wrong in the CD-BOX.CFG file. Either the player= or
  863.   parameters= command is missing, and both must be present.
  864.  
  865. .CMF: since CD-Box supports this format internally, you can also remove the
  866.   [CMF] section in CD-BOX.CFG (if there is one). This way, CD-Box won't try to
  867.   look for external drivers and/or players, and will use its own code to play
  868.   the songs.
  869.  
  870. .MOD: same as above
  871.  
  872.  
  873. ══════════════════════════════════════════════════════════════════════════════
  874. *** CD-Box doesn't play the song, and there is no error message!
  875. ──────────────────────────────────────────────────────────────────────────────
  876.  
  877. If CD-Box acts as if it will play a song, but in fact doesn't play it at all, 
  878.   and no error is generated, it may be because the song needs more memory to 
  879.   play - often the case with .MOD files above 250 KB, or with certain complex 
  880.   .ROL files. I'm working on ways to decrease the (huge) memory requirements
  881.   of CD-Box, but I can't do much better than the current version. Freeing DOS
  882.   memory and loading drivers high is definitely a bonus.
  883.  
  884. Another possibility is that the player got an error (usually out of memory,
  885.   but it could be corrupted bank file or something else), but reported none.
  886.   CD-Box is then fooled into thinking everything was okay. Try playing the
  887.   song by hand under DOS (using full pathnames, if the song is exploded on a
  888.   different drive/directory), and see what happens.
  889.  
  890.  
  891. ══════════════════════════════════════════════════════════════════════════════
  892. *** CD-Box displays "Unable to explode song"!
  893. ──────────────────────────────────────────────────────────────────────────────
  894.  
  895. CD-Box can't find PKUNZIP.EXE. Either make it available to CD-Box, remove any
  896.   .ZIP files containing songs you may have in CD-Box's directory, or run
  897.   CD-Box with the /L parameter.
  898.  
  899. .MUS and .ROL only: there is a second possibility: CD-Box has not found
  900.   the bank file. Try changing the name of the bank file associated to the
  901.   song, or if the name is okay, check that it is in the same .ZIP archive than
  902.   the song.
  903.  
  904.  
  905. ══════════════════════════════════════════════════════════════════════════════
  906.                          TROUBLE WITH .MOD FILES
  907. ══════════════════════════════════════════════════════════════════════════════
  908. *** CD-Box displays "Error loading .MOD"!
  909. ──────────────────────────────────────────────────────────────────────────────
  910.  
  911. CD-Box recognizes only 31-instrument .MOD files; you may have .MODs it won't
  912.   play even though players like ModPlay do. There are two solutions to this:
  913.  
  914.   * Use an external player to play .MOD files, either overriding completely
  915.       CD-Box's routines or using dual support (giving CD-Box a chance to play
  916.       the song and telling it to use the external player if it can't)
  917.  
  918.   * If you have ModEdit (or maybe another .MOD editor), load and save the .MOD
  919.       files. ModEdit will always save the song as a 31-instrument .MOD, so it
  920.       will be playable by CD-Box (it works all the time for me). I have a 
  921.       batch file that does this automatically as soon as I get new .MODs...
  922.  
  923.  
  924. ══════════════════════════════════════════════════════════════════════════════
  925. *** .MOD files sound terrible!
  926. ──────────────────────────────────────────────────────────────────────────────
  927.  
  928. Apart from using an external player, you can try changing the "MixingSpeed="
  929.   statement in CD-BOX.CFG. The higher the value, the better, but CD-Box's
  930.   feedback will slow down accordingly while playing .MOD files and might even
  931.   hang if you specify a value that is too high for your computer. The default
  932.   is 10000 Hz, 15909 Hz gives good results on computers fast enough.
  933.  
  934.  
  935. ══════════════════════════════════════════════════════════════════════════════
  936. *** Clicking on "Pause" while playback doesn't really pause!
  937. ──────────────────────────────────────────────────────────────────────────────
  938.  
  939. Well, YOU try pausing a .MOD file without killing it completely. Great fun.
  940.   No, seriously, if pausing doesn't work, just resume and try pausing again -
  941.   it works when they aren't too many instruments around. CD-Box has the same
  942.   pausing problems as ModPlay... no wonder, I use almost the same routines!
  943.  
  944.  
  945. ══════════════════════════════════════════════════════════════════════════════
  946.                            HARDWARE TROUBLE
  947. ══════════════════════════════════════════════════════════════════════════════
  948. *** I get a "VGA Sprite Manager has run out of memory" message!
  949. ──────────────────────────────────────────────────────────────────────────────
  950.  
  951. The VGA Sprite Manager is the routine responsible for animating sprites on the
  952.   VGA screen, not messing up the background, being able to superpose different
  953.   sprites on different planes, and preventing flicker. However, it also needs
  954.   a LOT of memory; 64 KB + the sprites to move, so it usually amounts to about
  955.   80 - 90 KB. So either free more memory before running CD-Box, or use the /F
  956.   parameter. The animations will be skipped, and the Sprite Manager will not
  957.   be invoked. But chances are you're too short on memory to play songs anyway.
  958.  
  959.  
  960. ══════════════════════════════════════════════════════════════════════════════
  961. *** CD-Box returns suddenly to DOS and I get a "CRASH!" message!
  962. ──────────────────────────────────────────────────────────────────────────────
  963.  
  964. Well, you stumbled on a bug. I left all the checking routines on in CD-Box's
  965.   code, so that instead of hanging up and forcing you to reboot, it exits to
  966.   DOS (in most cases).
  967.  
  968. Restart CD-Box and try not to do it again - if you use CD-Box normally, you 
  969.   shouldn't get any bug. It's when you try to insist (for example, a .MOD song
  970.   might not play because of insufficient memory, so don't try clicking on the
  971.   song button 10 times to try to play it anyway), that CD-Box crashes. I, of
  972.   course, am trying to get the number of bugs to an absolute minimum (very
  973.   close to zero).
  974.  
  975.  
  976. ══════════════════════════════════════════════════════════════════════════════
  977. *** I get "Not enough memory to..." messages and CD-Box returns to DOS!
  978. ──────────────────────────────────────────────────────────────────────────────
  979.  
  980. You have a fatal memory overflow. You have to free more memory; run CD-Box by
  981.   itself under DOS, not as a shell from another program. You can also try
  982.   typing CD-BOX /F at the DOS prompt, and if you can get to the main screen,
  983.   you may be safe... but you may also be too short on memory to play songs
  984.   anyway.
  985.  
  986.  
  987. ══════════════════════════════════════════════════════════════════════════════
  988. *** I have a SoundBlaster but am not able to play any songs!
  989. ──────────────────────────────────────────────────────────────────────────────
  990.  
  991. I have a SoundBlaster v1.50 so I'm sure CD-Box runs with this card. Above
  992.   versions should work, as well as any SoundBlaster compatible card - it runs
  993.   on the AdLib, and net users of CD-Box v2.01 report that it works with the
  994.   SoundBlaster Pro. However, a net user reported that it didn't work with his
  995.   SoundBlaster v1.05. Maybe the use of CD-BOX.CFG can solve this problem, but
  996.   nothing is guaranteed - I have no way to test that.
  997.  
  998.  
  999. ══════════════════════════════════════════════════════════════════════════════
  1000. *** I have trouble with my mouse!
  1001. ──────────────────────────────────────────────────────────────────────────────
  1002.  
  1003. YOU SHOULDN'T. CD-Box v2.01 did have problem with furry creatures, but this
  1004.   version should NOT any more. I left the following paragraph from CD-Box's
  1005.   v2.01 anyway...
  1006.  
  1007. CD-Box assumes the mouse is 100% Microsoft compatible (200% compatibility or
  1008.   more preferred). Some people have trouble with their mice (garbage on
  1009.   screen, focus offset); try using the .SYS or .COM or your mouse driver or
  1010.   even another driver. I know that some mice don't run well under CD-Box, even
  1011.   though they're 100% compatible, and they run fine under all other software.
  1012.   Sometimes changing the driver has worked, sometimes not. I have no perfect
  1013.   solution (yet).
  1014.  
  1015.  
  1016. ══════════════════════════════════════════════════════════════════════════════
  1017. *** That darn program doesn't work AT ALL!
  1018. ──────────────────────────────────────────────────────────────────────────────
  1019.  
  1020. Read the license (part V) if you haven't already done so.
  1021.  
  1022. I CANNOT GUARANTEE THAT CD-BOX WILL RUN ON YOUR PARTICULAR COMPUTER.
  1023.  
  1024. Let's be reasonable: I cannot guarantee that this program will work for you.  
  1025.   You MUST have a VGA display, a Microsoft compatible mouse, and a lot of free 
  1026.   RAM (at least 500 KB, 550 KB better; if you don't have 640K conventional
  1027.   memory, forget it - but then who doesn't these days?). This is the very
  1028.   minimum configuration under which CD-Box will run. If you want to hear the
  1029.   songs, you need an AdLib Music Synthetizer Card or a SoundBlaster card 
  1030.   (CD-Box does run, but is of absolutely no use without a music card). And if 
  1031.   you have a lot of songs, you need (a little) more memory, too, of course. I 
  1032.   have only tested in on 286s so far, and net users didn't report any problems 
  1033.   with their 386s and 486s; a 8086 might be slow, though. If you have a 8086, 
  1034.   you should try the /F parameter.
  1035.  
  1036. As far as I know, this program is free of bugs (except for those mentioned
  1037.   above). If you find any, TELL ME in detail! There's no chance of the bug
  1038.   being corrected if I don't know about it!
  1039.  
  1040.  
  1041. ══════════════════════════════════════════════════════════════════════════════
  1042.  
  1043.                            PART IV: EPILOGUE
  1044.  
  1045. ══════════════════════════════════════════════════════════════════════════════
  1046. Version history
  1047. ──────────────────────────────────────────────────────────────────────────────
  1048.  
  1049.   * 1.00: CD-Box is born
  1050.  
  1051.   * 1.10: Screen packing/unpacking routines shrink the resource file
  1052.  
  1053.   * 1.11: Right mouse button support, /? and /F command-line switches.
  1054.  
  1055.   * 1.20: Increased animation (5 digit display, CD spins)
  1056.  
  1057.   * 1.50: (Major rewrite) Introduction of the expert database (no data file
  1058.           needed), new button set to make changes within CD-Box, scrolling
  1059.           display, /I command line parameter added.
  1060.  
  1061.   * 1.51: Internal programming upgraded with objects!
  1062.  
  1063.   * 1.60: CD-Box keeps growing:
  1064.  
  1065.     - Support for .CMF and .VOC files; increased support for .ROL files, by
  1066.         being able to compute the playing time from the file on disk.
  1067.  
  1068.     - /V parameter added, so you can look into SONGS.DAT, and /P parameter
  1069.         added. At the same time, the internal database has been updated and
  1070.         expanded to 98 songs.
  1071.  
  1072.     - Addition of "Goto" mode, and "cleaning up" of the various buttons,
  1073.         dividing them into three distinct modes with different color themes.
  1074.  
  1075.     - The scrolling display scrolls up instead of left, and the messages stay
  1076.         a while on-screen - makes it much easier to read messages, which is
  1077.         all that display was about in the first place!
  1078.  
  1079.   * 1.61: "Bug" fix:
  1080.  
  1081.     - CD-Box starts checking for some cases of invalid .ROL formats, which
  1082.         made the program crash at startup while analyzing the file. Also, the
  1083.         /D has been added, so you can see which file causes the error, and
  1084.         remove it.
  1085.  
  1086.     - A most subtle bug causing black lines to sometimes appear on the song
  1087.         buttons has been tracked down and DESTROYED.
  1088.  
  1089.     - CD-Box's capacity extended to about 300 songs (I haven't tried more).
  1090.  
  1091.   * 2.00: CD-Box gets better, thanks to the network! (see thanks below)
  1092.  
  1093.     - Support for .MOD files, thanks to Mark J Cox's "quiet" player ModPlay.
  1094.         The drawback: I had to reorganize CD-Box's allocation routines so that
  1095.         they leave enough memory for ModPlay to load large songs (if you have
  1096.         about 570 KB free before you run CD-Box, a 210 KB .MOD file is about
  1097.         the maximum CD-Box can load) - so now CD-Box is again split in two
  1098.         files, CD-BOX.EXE and CD-BOX.RSR. It's no big deal, but...
  1099.  
  1100.     - INTERNAL SUPPORT FOR .CMF files has been added; now the digits display a
  1101.         real-time clock (time elapsed & time left & total time elapsed &
  1102.         left), and you can PAUSE and RESUME the song any time.
  1103.  
  1104.     - A percentage bar displaying time played/time left (which are recomputed
  1105.         at the end of each song if the length of the song just played proved
  1106.         to be longer than CD-Box thought it was) is added.
  1107.  
  1108.     - Some people felt frustrated not being able to move the mouse all over
  1109.         the screen. Okay! In this version, you are able to!
  1110.  
  1111.     - Still more songs added to CD-Box's internal database.
  1112.  
  1113.     - VGA screens updated and much prettier (thanks to advice on subtle light
  1114.         reflections), and random animations added!!!
  1115.  
  1116.   * 2.01: some little glitches fixed, others optimized (duplicates with same
  1117.       names but different extensions are now accepted as two distinct songs).
  1118.       Also, the first version to be released on wide-scale servers in the
  1119.       U.S.A. (SIMTEL and FTP sites supported by the Sound Newsletter).
  1120.  
  1121.   * 2.02: A few improvements & bug fixes
  1122.  
  1123.      - All (or most) 2-button cheese eaters should work well now
  1124.  
  1125.      - About 30 or 40 KB more free for those huge .MOD files.
  1126.  
  1127.      - A little less runtime errors, and a little more explicit messages.
  1128.  
  1129.      - Sprites as well as screens are shrinked in the resource file, saving
  1130.          50 KB (out of 220)! Hurray!
  1131.  
  1132.      - Some new animations, find them yourself!
  1133.  
  1134.   * 2.10: Inspired by net feedback...
  1135.  
  1136.      - INTERNAL SUPPORT FOR .MOD files. This, added to the fact that about
  1137.          30 KB of memory have been freed (despite CD-Box's growing complexity
  1138.          - over 1 Megabyte of sources!), means that monsters like "Flip House"
  1139.          can be played!!!
  1140.  
  1141.      - CD-BOX.CFG file added for maximum flexibility - CD-Box can now support
  1142.          ANY player that can run in "quiet" mode. What's more, if the formats
  1143.          evolve, you can override CD-Box's internal routines with an external
  1144.          player that supports the evolved format. Also, two parameters (.MOD
  1145.          mixing speed and temporary drive redirection) can be controlled from
  1146.          the .CFG file.
  1147.  
  1148.      - The pilot lights across the top (.CMF .MOD etc) are completely off if
  1149.          the corresponding format cannot be played (missing driver or player),
  1150.          so you know whether this format works without having to try and play
  1151.          a song file; in the same vein, unplayable songs are grayed when you
  1152.          select them. Also, /L (and /R) parameters added.
  1153.  
  1154.      - Files... mode added (rather easily to my own surprise - long live OOP!)
  1155.  
  1156.      - A *lot* of other small improvements...
  1157.  
  1158.   * Other ideas:
  1159.  
  1160.     - Keeping the "Forward" and "Rewind" buttons pressed down will quickly go
  1161.         through the pages, without having to release and press it each time. I
  1162.         have to find a way to make this work.
  1163.  
  1164.     - MORE INTERNAL SUPPORT for music files, without having to shell to
  1165.         external programs.
  1166.  
  1167.     - Support for any viable format I'll come across (all I need is a quiet
  1168.         player, freeware if possible (otherwise CD-Box itself might become
  1169.         shareware))...
  1170.  
  1171.     - I might work on a Windows version but that's another story...
  1172.  
  1173.     - Any more (viable) suggestions?
  1174.  
  1175.  
  1176. ══════════════════════════════════════════════════════════════════════════════
  1177. How you can help with CD-Box
  1178. ──────────────────────────────────────────────────────────────────────────────
  1179.  
  1180. I'm interested in sources or linkable object files to play .MUS, .ROL or .VOC
  1181.   files, since they allow the mouse to stay in control, the animation to
  1182.   continue, and the timer and percent bar are then displayed as real-time...
  1183.   and of course the user does not have to bother about a player program. If
  1184.   you have Pascal or C sources, or Turbo C .OBJ files that you're willing to
  1185.   share (provided it is legal to do so, i.e. your work, freeware, public
  1186.   domain, complete shareware archive), then write me. If I work them in, I'll
  1187.   acknowledge that in the documentation and in CD-Box itself (the About
  1188.   button).
  1189.  
  1190. I hope I'll be able to go on supporting CD-Box. I'm leaving for military
  1191.   service (obligatory in France), so I have no idea whether I'll be able to
  1192.   work on this or not. I think so but I'm not sure. Anyway, this version is
  1193.   stable and does not seem to be bugged.
  1194.  
  1195.  
  1196. ══════════════════════════════════════════════════════════════════════════════
  1197. Thanks to...
  1198. ──────────────────────────────────────────────────────────────────────────────
  1199.  
  1200. CD-Box would not be the program it is without the help from the following
  1201.   people - thanks to the net!
  1202.  
  1203. - Anthony Rumble, for his sources in Pascal of .CMF & .VOC routines
  1204.     (distributed as SBUTIL11.EXE). I have made my own librairies for .CMF now,
  1205.     but the critical routines were all supplied by Anthony (his .VOC player
  1206.     only works for files smaller than 64K, so I couldn't use it, but it's a
  1207.     good start!). My deepest thanks. Now all I need are .ROL routines that
  1208.     work...
  1209.  
  1210. - Mark J. Cox for his MODOBJ package which I happily registered, giving CD-Box 
  1211.     the opportunity to play great sounding Amiga soundtracks by itself. Mark J 
  1212.     Cox is also the author of ModPlay, a freeware terrific .MOD player which I 
  1213.     highly recommend; if you don't have it, go GET IT! (The latest version 
  1214.     should be at info.brad.uk, in /misc/msdos/mp.)
  1215.  
  1216. - Victor Langeveld for reporting two bugs in CD-Box v2.01 with enough detail
  1217.     to get them fixed in CD-Box v2.10; my heartest thanks. :-)
  1218.  
  1219. - Ed Haymore for prompting me to implement the temporary drive redirection,
  1220.     and for the main idea behind file selecting.
  1221.  
  1222. - Dave Komatsu, editor of the Sound Newsletter, and Keith Petersen, maintainer
  1223.     of the MSDOS, MISC and CP/M archives at SIMTEL, for having accepted my
  1224.     submission!
  1225.  
  1226. - Bruno Deltour for aesthetic remarks; Alain Rousseau for providing me *many*
  1227.     files from the net when I didn't have access to it; Jean-Francois Moufle
  1228.     for drawing the car (now much reduced) driving across the bottom of the
  1229.     screen at odd times; and various friends and relations for their stumbling
  1230.     on (thankfully rare) bugs, helpful comments and encouragement.
  1231.  
  1232. I hope you enjoy the song New Entertainer in the CDBOX210.ZIP archive - I
  1233.   programmed it myself! It is based, of course, on Scott Joplin's remarkable
  1234.   Entertainer (from the movie whose French title is "L'arnaque", and the
  1235.   English title I don't know), so the credit is his.
  1236.  
  1237.  
  1238. ══════════════════════════════════════════════════════════════════════════════
  1239.  
  1240.                     PART V: LICENSE & ABSENCE OF WARRANTY
  1241.  
  1242. ══════════════════════════════════════════════════════════════════════════════
  1243.  
  1244. The word "software" below refers to the four files CD-BOX.EXE, CD-BOX.RSR,
  1245.   CD-BOX.DOC and CD-BOX.CFG.
  1246.  
  1247. You may use this software, copy it as many times as you like, give it to
  1248.   anyone, and distribute it via electronic means. This software may also be
  1249.   distributed in shareware and/or public domain libraries that charge for
  1250.   copying and distributing disks, NOT for the software itself.
  1251.  
  1252. You may NOT charge or request a donation for a copy of this software, however
  1253.   made; and you may NOT distribute this program and/or documentation with
  1254.   commercial products without handwritten permission from the author.
  1255.  
  1256. THIS SOFTWARE MAY NOT BE GIVEN AWAY OR DISTRIBUTED WITHOUT ITS DOCUMENTATION;
  1257.   AND NEITHER PROGRAM NOR DOCUMENTATION MAY BE ALTERED IN ANY WAY.
  1258.  
  1259. CD-Box is delivered "AS IS" with no promise to its performance or fitness for
  1260.   a particular purpose. CD-BOX COMES WITH NO GUARANTEE OF ANY KIND, NOR IS THE
  1261.   AUTHOR LIABLE FOR DAMAGES OF ANY KIND. The person using this software
  1262.   assumes all the risks.
  1263.  
  1264. The software and documentation are copyrighted (C) Jeffrey Belt 1992.
  1265. All trademarks and registered names are acknowledged.
  1266.  
  1267. Do NOT use CD-Box if you do not agree to this license.
  1268.  
  1269.  
  1270. ══════════════════════════════════════════════════════════════════════════════
  1271. The bottom line
  1272. ──────────────────────────────────────────────────────────────────────────────
  1273.  
  1274. CD-BOX IS FREEWARE.
  1275. CD-BOX COMES WITH NO WARRANTY.
  1276. CD-BOX CANNOT BE USED FOR COMMERCIAL GAIN.
  1277. CD-BOX MUST BE DISTRIBUTED WITH THIS DOCUMENTATION.
  1278.  
  1279. The above is simply to make sure that:
  1280.  
  1281.   * You can copy and give CD-Box to anyone, and use it without any qualms.
  1282.  
  1283.   * Distributing CD-Box won't make me any trouble - hey, I'm giving it away
  1284.       for free!
  1285.  
  1286.   * This documentation stays with CD-Box; it contains acknowledgements and
  1287.       thanks to people who deserve it. Intellectual property is something many
  1288.       people don't seem to understand.
  1289.  
  1290.  
  1291. ══════════════════════════════════════════════════════════════════════════════
  1292.  
  1293.             PART VI: HOW YOU CAN SHOW YOUR APPRECIATION FOR CD-BOX
  1294.  
  1295. ══════════════════════════════════════════════════════════════════════════════
  1296.  
  1297. I have put an incredibly huge amount of time in this program (started in
  1298.   February 1991!), but I don't ask for any money for my work, only fame and
  1299.   recognition, as they say in the movies. However, one thing I DO ask for is
  1300.   user feedback. What do you like or don't like in CD-Box? Some of the 
  1301.   improvements of CD-Box v2.10 (as opposed to v2.01) were inspired by such 
  1302.   comments.
  1303.  
  1304. If you REALLY like CD-Box, and feel overly generous, a gift is always
  1305.   appreciated... :-) Any amount (say $5), any currency, even disks will do.
  1306.   Programming CD-Box is enjoyable, but by no means free...
  1307.  
  1308. To my greatest sorrow I currently have no access to the net, until further
  1309.   notice. I therefore have no e-mail address (the old one belt@aar... will no
  1310.   longer work). But snail mail works, so don't hesitate to write!
  1311.  
  1312. ******************************************************************************
  1313. ***                                                                        ***
  1314. *** I really insist on user feedback. I'm curious whether CD-Box will be   ***
  1315. *** successful on the network, and the only way I can know is if each user ***
  1316. *** (including YOU) sends me a note. A simple postcard of your home town   ***
  1317. *** will do. I'm not asking for "gee, you're so good" letters, I simply    ***
  1318. *** want to know where my creations go. And if you wish to write me for    ***
  1319. *** comments or suggestions, you are most WELCOME!                         ***
  1320. ***                                                                        ***
  1321. ***                     Jeffrey Belt                                       ***
  1322. ***                     7, rue de la Garenne                               ***
  1323. ***                     77240 - CESSON                                     ***
  1324. ***                     FRANCE                                             ***
  1325. ***                                                                        ***
  1326. ******************************************************************************
  1327.